
FTP Menu Help

                                               version: 1.1
                                               created: 00-10-30 12.38.57
                                           last update: 08/30/2001 {14:54:13 PM}


	  	Table of Contents


"# Abstract"
"# Activating the FTP menu"
"# Basic usage"
"# Startup problem with Fetch"
"# Cache"
"# Mount points"
"# Titlebar click"
"# Ftp filesets"
"# Passwords and Security"
"# Ftp Menu Items"
"# Ftp Menu Utilities"

<<floatNamedMarks>>


	  	Abstract


The FTP menu allows quick access to files on a remote ftp server, useful for
those that work on both unix and mac systems.  Files downloaded and opened
in Alpha with the help of the FTP menu are automatically uploaded again when
they are saved.  The idea is that the user can have the appearance of
editing files on a remote site.  To set this up, all that is needed is the
name of the site, and a valid username and password.  

The FTP menu works together with the three ftp clients Interarchy, Fetch and
NetFinder, and with Alpha 8/tk can actually access ftp servers without the
help of any external client by using the ftp package contained in the
'tcllib' distribution.

Note: If you actually wish to keep the 'master copies' of some files on your
local machine and have them mirrored on a remote site, then this can be done
either through HTML mode's 'Upload Home Page' facility, or for any fileset
by activating the 'Fileset Ftp Mirror' package.  In this case you will not 
be using the FTP menu directly, and this documentation will not be that
useful.


	  	Activating the FTP menu


The FTP menu is activated in the dialog "Config -> Preferences -> Menus" .
Check the checkbox 'Ftp Menu' among the global menus.

You must also choose either Interarchy, Fetch, or NetFinder as your ftp
helper application.  The "Config -> Preferences -> Helper Applications"
menu item allows you to set/change your helper app as necessary.  Both 
Alpha 8 and Alphatk can act as ftp clients themselves.  If you prefer,
you can select 'Use Tcl Service For Ftp' in "Config -> Preferences -> WWW"
and no external helper application is necessary.


	  	Basic usage


The first you need to do is to get a list of the files at a remote site.
This can be done by using the menu item 'Browse Remote'.  A dialog is now
opened where you fill in the host, path (optional), user id, and password.
(Alpha 7 doesn't support text fields in dialogs where the text is replaced
by bullets.  Therefore the password box is made so small that nobody can see
what you type.)

Your ftp client (Interarchy, Fetch, or NetFinder) will now get a listing of
the files at the remote site.  The list is display in a list dialog.

   Selecting a file in the dialog will download it and open it for editing 
    in Alpha.  Once you save the changes, Alpha tells your ftp client to
    upload the file.

   Selecting a directory in the list (indicating by a trailing / in the 
    name) will get the listing of that directory and display it in a new
    list dialog.

   Selecting '..' in the list will get a listing of the parent directory.

A menu item with your remote machine is added to the FTP menu.  Selecting
this menu item will the display the file list again.  This allows you to
quickly download another file from the same place.


	  	Startup problem with Fetch


If Alpha launches Fetch from the FTP menu, Fetch occasionaly get stuck 
after displaying its sign-on dialog. If this happens you have to switch to 
Fetch and dismiss this dialog before Fetch continues working. To avoid this 
problem completely uncheck "Show sign-on dialog at startup" in Fetch's Misc 
preference dialog.


	  	Cache


Alpha saves the directory listing in a cache to be able to quickly display
them again without having to download them every time.  Whenever new files
are added to the remote site the cache becomes out of date.  You can clear
the cache by selecting 'Flush Cache' from the FTP menu.  The cache is also
flushed when you quit Alpha.  This forces the directory listing to be
downloaded again.  If you don't want to use a cache at all, uncheck 'Use
Cache' in the FTP menu.


	  	Mount points


The point where you start browsing a remote site is called a mount point. 
There are two types of mount points: temporary and permanent.

   Temporary mount points are mount points which only exist during the 
    current session with Alpha.  Whenever you use 'Browse Remote' to browse
    a new site a temporary mount point is created.  All temporary mount
    points are listed at the bottom of the FTP menu for quick access.

   Permanent mount points are mount points which are saved between 
    sessions with Alpha.  You create a new permanent mount point by using
    'Add Mount Point' in the FTP Utils menu.  You can later remove it using
    'Remove Mount Point'.  The permanent mount points are listed in the FTP
    menu just above the temporary ones.

You can always make a temporary mount point permanent by using the menu item
"Ftp Menu Utils -> Make Permanent".


	  	Titlebar click


Clicking on the titlebar of a window downloaded from a remote site (or in
Alphatk right-clicking anywhere in the window) displays a popup menu with
the path for the file at the remote site.  Selecting a directory in this
popup menu opens a directory listing dialog with all files allowing you to
download another file.  This gives you quick access to the remote files.


	  	Ftp filesets


An ftp fileset in a set of files in a remote directory, which will be put
in a submenu in the Fileset menu.  Selecting a file in the Fileset menu
will download and open it for editing in Alpha.

You create a new ftp fileset by using 'Create Fileset' in the FTP menu or
by using 'New Fileset' in the Fileset menu and choosing the type 'ftp'.

   First you specify a name for the fileset, which will be the name of the 
    submenu in the Fileset menu, and information about the host, userid etc.

   Then you are asked to specify a pattern which determines which files to 
    include in the fileset, e.g. you may only wish to include all .html
    files.  This pattern must be entered as a regular expression.  Some
    examples how to specify the pattern:

	.*          all files
	.*\.html    all .html files
	.*\.[ch]    all .c files and all .h files

   You are finally asked if you want to save the fileset. Doing so will 
    keep it available next time you run Alpha.
    
Now the listing of the files in the fileset is downloaded and the fileset
is inserted in the menu.


	  	Passwords and Security


All passwords which are saved between sessions are saved as plain text in
Alpha's preferences folder.  Thus, only give your password when defining
permanent mount points or filesets if nobody else has access to your
computer.  If you attempt to open a remote site or file for a mount point or
fileset that has no password, you will be prompted to enter it in a separate
dialog.  This password will be remembered until Alpha is quit, or until you
select the "Ftp Menu Utils --> Forget Temp Passwords" menu item.  No
temporary passwords are saved between editing sessions.


	  	Ftp Menu Items


This section lists all menu items in the FTP menu giving a short description
of their functionality.

	Browse Remote

Browse a remote site.

	Browse Current (option)

Browse the mount point of the frontmost window.

	Browse Mounts

Lets you pick a mount point to browse from a list of all your mount points
both temporary and permanent.

	Ftp Menu Help

Opens this file.

	Save As At

Lets you 'Save as' the frontmost window at any of your mount points.

	Save A Copy At

Lets you save a copy of the frontmost window at any of your mount points.


	  	Ftp Menu Utilities


	Add Mount Point

Add a new permanent mount point.  The 'password' field is optional.
After adding a mount point, you are given the option to add more if
desired.

	Edit Mount Point

Edit any previously saved mount point.  After editing a mount point, you
are offered the list of all saved mount points again to select another
to edit if desired.

	Rename Mount Point

Rename any previously saved mount point.

	Remove Mount Point

Remove a permanent mount point.

	Make Permanent

Make a temporary mount point permanent.

	Create Fileset

Create an ftp fileset.  The password field is optional.

	Set Defaults

Lets you set default ftp mount point values, including host, directory,
username, and password.  Any or all of these values can be set, and will be
used in the initial "login" dialog.  (If you are adding several mount points
at once, the login dialog will remember the values from last one added in
this editing session.)

	Use Cache

If checked, all directory listings are stored in a cache.  Otherwise, the
remote site is accessed whenever obtaining a listing for a mount point, or 
to reload a remote file which has since been closed.

	Flush Cache

Deletes all files in the cache.  The cache is also flushed whenever you quit
Alpha.  Note that if you have any currently open remote files, it will only
be possible to save them after flushing the cache by using the 'Save As At'
menu item.

	Forget Temp. Passwords

Flush the cache of all temporary passwords remembered this session, those
that Alpha has specifically prompted you for in a separate dialog when
attempting to open a remote site or file.



